Internet Info 1994 March

home *** CD-ROM | disk | FTP | other *** search

/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / b / ikxker.bwr < prev next >

Wrap

Text File | 1993-05-24 | 40.2 KB | 741 lines

CICS Kermit 4.2.x "Beware File" - Known Bugs, Problems, Limitations. As of: 17:35pm Friday, 1993 May 21 This file contains (A) instructions for applying Kermit updates, (B) a list of unresolved problems, (C) a list of problems with work-arounds or optional fixes, and (D) a list of resolved problems. Kermit-CICS is still a new product and has been used at relatively few sites and only with releases 1.6, 1.7, and 2.1 of CICS. There may be problems of incompatibility with other releases, and some features may not have been fully tested under each of these releases. The list of resolved problems in part (D) includes an initial batch of the most interesting fixes to problems found in other variants of Kermit-370, in addition to any fixes found for Kermit-CICS after the release of 4.2.2. Bug reports should be sent to John Chandler <JCHBN@CUVMB.CC.COLUMBIA.EDU>. NOTE: entries will sometimes be entered under (D) even though the needed updates have not been released in IKXKER.UPD. Please check the date of the UPD file to see if it has been changed before requesting a new copy. Kermit-370 now carries an "edit" number in addition to the version and release numbers. The three numbers together are printed out in the assembly listing and displayed by Kermit at startup time. Be sure to include all three numbers (e.g., 4.2.3) along with any error reports. A) Update instructions ................................................. Many updates have been received since Kermit-370 4.2 was released. In general, updates received at Columbia will not be applied to the source files in the CICS Kermit distribution until and unless "major" bugs are uncovered, and then all accumulated updates will be applied at once. However, since the CICS variant of Kermit-370 is new, updates to system- specific code have been ported to CICS and applied to the sources in the process of creating 4.2.2, even though the corresponding updates to the generic code have been collected together in IKXKER.UPD. If your source does not include the line defining &KVRSN to be 4.2, you should obtain an all-new source distribution from Columbia. The description of each problem and a pointer to its solution will always be included in IKXKER.BWR (the present file), but the updates themselves are to be found in IKXKER.UPD. The procedure for updating your copy of CICS Kermit is as described in IKXKER.INS. When new updates become available, and you wish to apply them, the following hints may prove useful. 1) Obtain the latest version of IKXKER.UPD, which contains all the updates as a composite file punctuated by comment lines introducing each update's name and briefly describing its purpose. Please note that some modes of file transport have a side effect of either doubling or removing any periods in the first column -- if your copy of IKXKER.UPD has records beginning with "/", then all instances of "/" in column 1 should be changed to "./", and all records with "@" in column 63 (introducing an update code normally found starting at column 64) should be moved over to make room for a "." in column 1. Similarly, any instances of ".." in columns 1-2 should be changed to just ".". A related problem can affect the sources by leaving a blank in column 80. That can happen via the loss of a "." in column 1 (in which case the sequence number will be shifted into columns 72-79) or via automated efforts to preserve the "." (in which case the sequence number will be truncated). The repair consists of inserting the missing "." in column 1 or "0" in column 80. 2) Determine the date of your sources. If you obtained the source from Columbia, the date is the value of the &KDATE variable symbol in the source itself, i.e., the release date of the current base version. If you received the source distribution from a secondary supplier, you will need to examine the code to determine the most recent update applied. Just sort the combined source by columns 67-71; the last line will be labelled with the last-applied update. At present, the generic and CICS-specific code have different effective dates (see above). The generic date is the one of interest. 3) If your sources are "pure" Columbia 4.2, go on to step 4. Otherwise, you must take care to avoid applying updates that are already in the source. If it is inconvenient to obtain "pure" sources, you must go through the list of updates at the beginning of IKXKER.UPD and remove the entries for updates already included in (i.e., older than) your sources. Each line of the list begins with "./ *" plus an update code in the form xxyyddd (the yyddd is just the date of the update -- the list is arranged chronologically). Also, go through and discard those updates from the file. Each update begins with a second copy of the line from the list and goes to the next such line. The updates are also in chronological order. Note that individual update control cards generally have time tags, but these are not necessarily accurate and should not be taken seriously. 4) Extract any desired optional updates from IKXKER.BWR (this file) and group them together with any local modifications specific to your site. NOTE: all updates in this file are indented one column to avoid all the transmission problems mentioned above in step 1. Be sure to shift everything over when you extract the updates. 5) Apply the updates by following the instructions in IKXKER.INS. ------------------------------------------------------------------------ B) Unresolved problems ................................................. ---------------- 89/1/20 ----------------------------------------------- Now that Kermit-370 supports multiple-filespec SEND, it is possible for a single SEND subcommand to specify overlapping wildcard filespecs. Only the CMS variant keeps track and makes sure that it doesn't send the same file twice within one send invocation. The others, including CICS Kermit-370, may send the same file again, and it is left to the user to prevent filename-collision problems on the receiving end. ---------------- 90/5/8 ------------------------------------------------ With a few exceptions, CONTROLLER will be set automatically when Kermit is invoked. See file IK0AAA.HLP in the Kermit distribution for a list of front ends that have been reported to allow Kermit file transfers and another list of reported failures. ---------------- 91/6/11 ----------------------------------------------- Kermit-CICS is a new TEST release, and some of the planned features have not yet been implemented. Here is a brief list, ordered roughly by the importance and likelihood of implementation. Some of these features are to be added through separate programs or exit routines, but others by modification of Kermit itself. Some, such as #1, #4, and #5, would be locally developed, but the Kermit distribution would include one or more samples. 1. Algorithms for assigning a "userid" other than the OPID, TERMID, or USERID. See IKXKER.INS for details. 2. I/O for spool files, to be supported by IKXDYNAL. See IKXDYN.HLP for details. 3. I/O for MVS data sets, to be supported by IKXDYNAL. ditto. 4. I/O for other special-purpose "pipes". ditto. 5. Data security exits. See IKXKER.INS for details. 6. Local option for the action to take in response to BYE. 7. Local option on limitations of use of TS space, starting with a simple test of whether there is enough TS space of the desired type for an inbound file. 8. I/O for data objects on a remote CICS. 9. Detection of the existence of data in output extra-partition TDQ's. 10. Time-outs for packet I/O. 11. Interception of terminal I/O from programs invoked by Kermit. 12. A true file system including generalized filetypes, rather than just a restricted list, as at present. ---------------- 91/6/28 ----------------------------------------------- Dynamically defined TD queues apparently do not reside in the DCT along with hard-coded queues. Kermit-CICS may not be able to read or write them. There may be limits on the size of TS queue records other than the general CICS maximum of 32767. If such limits exist, you may need to reduce the &MAXLR global symbol in Kermit in order to force truncation or folding at a save level. However, such a change would preclude writing such long records to Kermit directory members as well. As with any multi-user environment, it is possible for a data object scheduled for downloading via a wildcard filespec to disappear from the system before its turn comes. If that should happen, the transfer will halt with an "I/O error". On the other hand, if a new object appears after the transfer has begun, it will not be sent, even if it matches the wildcard specification. This problem applies mainly to TS queues. There is no HOST RENAME function supported by Kermit. There is also no APPEND option for the HOST COPY function. There is a bug (or feature) in the handling of filespecs for the simulated system commands TYPE, COPY, DELETE, and DIRECTORY. If the filetype is omitted, a filetype of TAKE, rather than TS, is assumed. ---------------- 91/10/31 ---------------------------------------------- Kermit-CICS has conditional assembly code for access to extra-partition TD's under CICS 1.6 and earlier, but it works only for CICS/OS/VS (MVS); there is no provision for DOS/VSE. ------------------------------------------------------------------------ C) Problems with workarounds or optional fixes ......................... ---------------- 89/2/27 ----------------------------------------------- The code for detecting the difference between SERIES1- and GRAPHICS-type terminal controllers may cause peculiar error messages at session startup, particularly if you wish to run Kermit on an IBM 3270-type terminal. Normally, Kermit can recover from these error conditions, but some configurations and/or versions of VTAM may hang the terminal session instead or have other undesirable side effects. For example, there may be an error message IKT00405I SCREEN ERASURE CAUSED BY ERROR RECOVERY from VTAM that never goes away. In that case, there are several possible cures. First is the simple expedient of pressing PA1 to clear the error condition. If that doesn't help at your site, you may find that logging onto the host via Netview's TAF component makes the error message appear only once. If you cannot start Kermit reliably, you might want to bypass the code (especially if you don't have any GRAPHICS-type terminals). The code is governed by a set of switches which can be tailored to your needs: STCQBIT EQU X'01' WSF Query is always allowed STCQNS1 EQU X'02' WSF Q implies *not* SERIES1 STCS1 EQU X'04' Always assume SERIES1 STCNOS1 EQU X'08' Always assume *not* SERIES1 STCNORD EQU X'10' Asynch READ MOD is forbidden Because there is apparently no way to determine from within a program whether WSF Query is allowed for a particular terminal and because CICS does not provide for Read Modified commands without waiting for an Attention interrupt, the standard flag value on CICS is STCNORD+STCQBIT; if you wish to force the code to select SERIES1, you should change that to STCNORD+STCS1, as in the following: ./ * SC9131X - Customize controller type selection ./ R 01205200 $ 1205200 100 11/21/91 00:16:50 &CONOPTS SETC 'STCNORD+STCS1' SETCON options @SC9131X Alternatively, if you have *only* GRAPHICS-type controllers, you could change it to STCNORD+STCNOS1 (or STCNORD+STCNOS1+STCQBIT if you have 3174 AEA controllers). ---------------- 90/7/5 ------------------------------------------------ Kermit-370 honors the file type specification (binary or text) given by a sending Kermit in an Attribute packet. Issue the SET FILE TYPE to both sending and receiving Kermits (to be safe). ---------------- 90/7/30------------------------------------------------ When the file type is TEXT and the recfm is F, Kermit-370 strips off trailing blanks from each record before sending a file. In order to keep trailing blanks in a downloaded file, you can convert it to RECFM V before sending it, e.g., by using HOST COPY to move it to a TS queue. ---------------- 90/8/22 ----------------------------------------------- If, for some reason, the other Kermit insists on pretending ASCII bytes all have the 8th bit set, Kermit-370 will not detect the intended CRLF separators between lines. The result of uploading from such a Kermit is a (text) file with only one record. If the other Kermit cannot be fixed, the following update will make Kermit-370 treat ASCII 8D and 8A the same as 0D and 0A, as long as the ATOE table does so. ./ * SC90151 - Forgive 7-bit ASCII files with 8th bit on ./ I 02490500 $ 2490700 200 08/03/90 16:06:46 ISW78 DC X'7F' Start with 7-bit ASCII @SC90151 ./ I 02713500 $ 2713700 200 08/03/90 16:06:46 SW78 DS X'7F' Switch for 7-bit/8-bit ASCII @SC90151 ./ I 03436000 $ 3436500 500 06/01/90 13:24:03 KCALL TBLCRLF Note current treatment @SC90151 ./ I 03442000 $ 3442500 500 06/01/90 13:24:03 KCALL TBLCRLF Note current treatment @SC90151 ./ I 04318000 $ 4318500 500 06/01/90 13:24:03 KCALL TBLCRLF Reset 7-bit/8-bit mask for CRLF @SC90151 ./ I 04386000 $ 4386080 80 06/01/90 13:24:03 * * Entry: nothing special @SC90151 * Exit: SW78 set up correctly @SC90151 TBLCRLF ENTER ALT @SC90151 MVI SW78,255 Assume 8-bit codes @SC90151 CLC ATOE+ALF(1),ATOE+ALF+128 @SC90151 BNE RTRN0 @SC90151 CLC ATOE+CR(1),ATOE+CR+128 @SC90151 BNE RTRN0 @SC90151 MVI SW78,127 No, 7-bit codes @SC90151 B RTRN0 @SC90151 ./ I 08048000 $ 8048400 400 NC CUR,SW78 If 7-bit ASCII, ignore 8th bit @SC90151 ---------------- 91/5/30 ----------------------------------------------- The "factory" settings for several of the Kermit options may be unsuited to the operation at a given site. Here are updates to change some of the most likely parameters to need changing. ./ R 01208000 $ 1208000 500 LIMDSK EQU 65536 Reduce user directory space quota @SC91150 ./ R 01209000 $ 1209000 500 CUTDSK EQU 300000 Increase directory space cutoff @SC91150 ./ R 01226000 $ 1226000 500 &USER SETC 'TERM' Use TERMID for user id @SC91150 ./ R 01226000 $ 1226000 500 &USER SETC 'UID' Use USERID for user id @SC91150 ./ R 01226000 $ 1226000 500 &USER SETC 'OTHER' Use exit routine to get user id @SC91150 ./ R 01411550 $ 1411550 10 &KTRACE SETC 'YES' Enable tracing @SC91150 ---------------- 91/11/21 ---------------------------------------------- In order to change the default Kanji encoding from IBM-style to another, add one of the following updates. ./ * SC9132X - Change Kanji default ./ R 01411560 $ 1411560 10 11/21/91 @SC9132X &KNJDEF SETC 'HITACHI' Default Kanji @SC9132X ./ * SC9132X - Change Kanji default ./ R 01411560 $ 1411560 10 11/21/91 @SC9132X &KNJDEF SETC 'FUJITSU' Default Kanji @SC9132X ---------------- 92/4/10 ----------------------------------------------- The minimum size of strings to be subjected to run-length encoding may need to be changed to two to make the new FULLSCREEN mode work on certain protocol converters, such as the MICOM 7400, which convert three successive blanks into cursor motion commands (or even two!). The following update accomplishes that. ./ * SC92101 - Encode multiple blanks ./ I 07929000 $ 7929050 50 04/10/92 17:35:12 CLI 0(8),ABL Is it a blank? @SC92101 BNE ENCRP1 No, use normal criterion @SC92101 C 14,F2 @SC92101 BNL ENCRP2 Always encode multiple blanks @SC92101 ENCRP1 DS 0H @SC92101 ./ I 07929600 $ 7929800 200 04/10/92 17:35:12 ENCRP2 DS 0H @SC92101 ---------------- 92/7/8 ------------------------------------------------ Running Kermit under CICS in a BTAM environment with a Yale-type protocol converter may require the application of APAR PN00282 to avoid continually getting out of transparent mode during a file transfer. The specific CICS component affected is DFHTCP. ---------------- 92/7/13 ----------------------------------------------- Assembling Kermit with the VSE-F assembler (which may be the only choice on some VSE systems), requires a small change in the input in order to prevent confusion over the global variable symbols. The following update achieves that (and is harmless for other assemblers). ./ * SC92178 - Satisfy F assembler ./ R 01401000 01402000 $ 1401000 1000 06/26/92 13:03:43 * Global variable declarations for open code @SC92178 ./ I 01402600 $ 1402700 100 06/26/92 13:03:43 TITLE 'Kermit-370 Control blocks and constants' @SC92178 PRINT NOGEN @SC92178 Another small change can be made in the installation to avoid a harmless error message from the assembly of IKXTRN -- remove the END statement from the source file and insert a " PUNCH ' END'" into the JCL after the " PUNCH ' COPY IKXTRN'". ---------------- 92/10/18 ---------------------------------------------- When Kanji characters are first selected, the default for the single- byte character set is CP290 (hard-coded in Kermit-370). That can be changed, however: ./ * SC92252 - Make CP281 the default SBCS with KANJI ./ R 04448600 $ 4448600 100 10/18/91 20:52:19 TBVJP DC CL(LALF)'CP281',CL(LALF)'CP500',CL(LALF)'CP290' @SC92252 ---------------- 93/1/21 ----------------------------------------------- Kermit-370 in FULLSCREEN mode can be at the mercy of clever efforts toward screen "optimization" by the protocol converter. One possible symptom is the suppression of the last outbound packet in a transfer if the screen is cleared just afterwards. This may happen after an upload or upon leaving server mode. To avoid this possibility, Kermit-370 can simply wait a few seconds to give the protocol converter less excuse for suppressing the last packet. The following update uses four seconds, but the optimum time may be more or less, depending on the system. ./ * SC93021 - Try to prevent end effect in FULLSCREEN mode ./ I 08645400 $ 8645500 100 01/22/93 12:31:55 CLI TRMTP,C'F' @SC93021 BNE INTINICN Go if not FULLSCREEN @SC93021 LA 0,4 Wait four seconds to synchronize @SC93021 KCALL SUPFNC,9 @SC93021 INTINICN DS 0H @SC93021 ---------------- 93/5/21 ----------------------------------------------- Kermit-CICS sometimes has trouble synchronizing read and write commands on GRAPHICS-type protocol converters. The symptom is a lost packet when the micro sends before the mainframe is ready. There is a cure, but it can't be applied generally because it may kill transfers on terminals defined with the automatic up-casing option. For some reason, the ASIS option is not permitted for the CICS CONVERSE command, which is the centerpiece of the update below. Users are invited to experiment with this update by moving the comma from before to after the word "ASIS" on the line marked with "???" and/or to try the update with terminals set for automatic upcasing. If results are favorable, this update may be added permanently to Kermit. ./ * SC93110 - Ensure line turnaround (CICS) ./ I 01131000 $ 1132000 1000 04/21/93 22:14:44 SCRCTLCH DS X WCC for next output op @SC93110 ./ R 05540400 $ 5540400 40 04/21/93 22:14:44 BE SCRNEXWS Expecting a reply - save ptrs @SC93110 ./ R 05542500 05543500 $ 5542500 300 05/20/93 17:36:43 CLI WRRD,5 @SC93110 BNE *+12 Not expecting a reply - just send @SC93110 CLI CONSOPR,6 Write message? @SC93110 BNE SCRNEXWS No, save ptrs @SC93110 * MVI SCRCTLCH,X'C1' Yes, lock it to prevent clash @SC93110 ./ I 05545000 $ 5545200 200 04/21/93 22:14:44 MVI SCRLSTIO,0 Clear I/O code @SC93110 ./ I 05545500 $ 5545600 100 04/21/93 22:14:44 SCRNEXWS MVC SCRLSTIO,0(8) Save code of last I/O @SC93110 B SCRNEXZ @SC93110 ./ I 05549000 $ 5549200 200 04/21/93 22:14:44 L 3,SCRLSTIO @SC93110 ./ D 05550150 04/21/93 22:14:44 ./ R 05550250 $ 5550250 10 04/21/93 22:14:44 FROM(0(,3)) FROMLENGTH(SCRLSTIO+6), @SC93110+ ./ I 05551000 $ 5551060 60 04/21/93 22:14:44 CLI SCRLSTIO,0 Saved WRITE operation? @SC93110 BE SCRNEXRR No, fine @SC93110 EXEC CICS CONVERSE CTLCHAR(SCRCTLCH), @SC93110+ FROM(0(,3)) FROMLENGTH(SCRLSTIO+6), @SC93110+ INTO(0(,7)) TOLENGTH(GTMLEN), ASIS ??? @SC93110 B SCRNEXR2 @SC93110 SCRNEXRR DS 0H @SC93110 ./ D 05559000 04/21/93 22:14:44 ./ D 05569000 04/21/93 22:14:44 ------------------------------------------------------------------------ D) Resolved problems ................................................... Note: the following items include a selection of the generic entries for other variants of Kermit-370. ---------------- 90/5/8 ------------------------------------------------ A commonly reported "problem" is that Kermit-370 objects to a send packet size greater than 94, and users wonder how to turn on long-packet protocol for downloads. The answer is that the the maximum packet size in Kermit protocol is always dictated by the receiving Kermit -- ALWAYS. NOTHING YOU CAN SAY TO A SENDING KERMIT WILL EVER MAKE IT SEND PACKETS LONGER THAN THE RECEIVING KERMIT ASKS FOR. Conversely, Kermit-CICS will always use packets as long as possible unless frequent transmission errors indicate a noisy communication line. The only purpose for the send packet-size parameter in Kermit-CICS is to set the default, in case the receiving Kermit is badly crippled (in which case, long packets are entirely out of the question anyway), or to control "raw" downloads (those without Kermit protocol and parameter negotiation). ---------------- 90/6/22 ----------------------------------------------- Kermit-370 supports file transfers through the IBM 3174 AEA with level 2 microcode in configuration B. The support is restricted to terminal types defined in the 3174 to have ASCII Graphics capability. That capability is available by default only for VT241 and Tektronix 4205 terminals, but user-defined terminal types are also possible. Also, the Graphics capability is allowed only for lines defined without associated Host Addressible Printers. Kermit-370 now automatically detects the B2 AEA and sets CONTROLLER accordingly (to AEA if Graphics is allowed, to NONE if not). However, if the 3174 is owned by VTAM, and the connection is made with a logmode that forbids the Read Partition Query (such as M2SDLCNQ), Kermit cannot detect the AEA and will default to CONTROLLER GRAPHICS (and, incidentally, cannot transfer files even with CONTROLLER set to AEA by hand). M2SDLCQ is known to allow correct operation, but other logmodes have not been tested. Since the 3174 supports full 8-bit communication, it may be useful to configure the ports for 8-bit data and to set both SEND and RECEIVE PARITY to NONE in Kermit-370. The fix: SC90173. Note: B2 microcode became available from IBM in May 1990. B3 followed soon afterward, and it supports file transfer the same way as B2. ---------------- 90/9/7 ------------------------------------------------ Kermit-370 now has a TRANSPARENT transfer character set, which applies a null translation to all incoming and outgoing files. The fix: SC90250. ---------------- 90/10/5 ----------------------------------------------- Kermit-370 now has a SET TTABLE KP option which enables a full 8-bit translation table based on Hollerith codes. The fix: SC90278. ---------------- 90/12/5 ----------------------------------------------- Kermit-370 now has a VERSION subcommand, which displays the version number and date. The fix: SC90339. ---------------- 91/4/26 ----------------------------------------------- Kermit-370 now supports a "CC" option along with the line range for sending files. This option specifies that the file has carriage control in column 1 and that it should be converted to ASCII control characters. For example: SEND filespec<_CC> (the underscore is the option delimiter and indicates here that no line range is given). The fix: SC91116. ---------------- 91/6/29 ----------------------------------------------- Kermit-370 now supports 8th-bit quoting for the XECHO subcommand, using the same prefix character as in Kermit protocol. The quoting can, thus, be turned off. The fix: SC91180. ---------------- 91/9/4 ------------------------------------------------ Kermit-370 no longer halts a transfer upon seeing a data packet with no data. The fix: SC91247. ---------------- 91/9/13 ----------------------------------------------- Kermit-370 now allows the STOP command on PCI and certain other protocol converters that did not previously support it. The fix: SC91256. ---------------- 91/9/18 ----------------------------------------------- Kermit-CICS supports a special file naming construct for TS queues. If the string ";;;;" appears in the name given to Kermit, that is replaced by the terminal id of the current session. This is useful for avoiding name conflicts when two or more users are running Kermit at the same time. The fix: SC91260 in IKXKER.UPD (included with release 4.2.2). The special string may also be set to any other desired four-byte string. This feature was added too late to appear in the User's Guide, so the only documentation is this description. To alter the special string, simply find the definition of variable symbol &KTRMS in the update and change it to the desired new string (which must be exactly four characters). The string also should not contain any reserved characters, such as Asterisk, Percent, Period, Slash, Less-than, Comma, or Blank, and should not begin with quasi-reserved characters such as Apostrophe or Question mark. ---------------- 91/9/20 ----------------------------------------------- Kermit-370 no longer gives a spurious reason for a cancellation issued by user intervention on the micro. The fix: SC91263. ---------------- 91/9/26 ----------------------------------------------- Kermit-CICS now distinguishes between readable and writable data objects when determining file name collision and searching for files to download. In particular, it will not attempt to download a write-only extra-partition TD in response to a wildcard specification. The fix: SC91269. ---------------- 91/10/2 ----------------------------------------------- Kermit-370 supports locking shift protocol (helps to compress certain files with many 8-bit bytes). The fix: SC91275. ---------------- 91/10/8 ----------------------------------------------- Kermit-370 now avoids looping when a solid terminal I/O error sets in or upon any error at the very end of a transfer (no reply expected). The fix: SC91281. ---------------- 91/10/11 ---------------------------------------------- Kermit-370 now uses the built-in default A-to-E translation table for interpreting Kermit commands in server mode when the transfer character set is TRANSPARENT. The fix: SC91284. ---------------- 91/10/22 ---------------------------------------------- Kermit-370 now suggests changes in some settings if the initialization file(s) haven't adopted the new-and-better values. This avoids changing the built-in defaults. The fix: SC91295. ---------------- 91/10/31 ---------------------------------------------- Kermit-CICS has conditional assembly based on the level of CICS. At present, the only test is between level 1.6 and higher levels, and the only affected operation is access to extra-partition TD's. The code selected for CICS 1.6 was intended for CICS/OS/VS (MVS), but there was an incorrect offset. There is still no corresponding code for DOS/VSE. The fix: SU91304. ---------------- 91/10/31 ---------------------------------------------- Kermit-CICS now pads the interactive mode prompt with XON (or whatever is the current HANDSHAKE character). This may be necessary to avoid locking the terminal in some configurations. The fix: SC89334. ---------------- 91/11/7 ----------------------------------------------- The terminal type detection code has been moved to the generic part of Kermit-370, except for a few flags that define system-specific limitations. The tried-and-true optional update SC89058 has been revised and renamed SC9131X accordingly (see above the note dated 89/2/27). The fix: SC91311. ---------------- 91/11/8 ----------------------------------------------- Kermit-370 now has a SIMULATE subcommand, which plays back a file giving one or both sides of a file transfer to supply the packets (instead of the communication line). This facilitates testing new protocol features one Kermit at a time. Lines in the "canned" file are ignored if they begin "S:", are translated from EBCDIC to ASCII if they begin "R:", and are taken as "raw" I/O otherwise. SIMULATE automatically reverts to normal packet I/O either at the end of the file or upon detection of an error. The filespec has the same defaults as for the TAKE subcommand. The fix: SC91312. ---------------- 91/11/12 ---------------------------------------------- Kermit-370 now tolerates alternate EBCDIC versions which do not have all the Roman letters at the standard code points. If the source is passed though a filter that consistently translates certain characters to other code points, the resulting executable program will adopt the same convention, and upcasing and downcasing will follow the new pattern. In particular, this may be necessary in Japan on systems that use the codes normally attached to lower-case Roman letters for Katakana. The fix: SC91316. ---------------- 91/11/16 ---------------------------------------------- The language-specific use of one-letter abbreviations of SET options for program logic flow has been generalized by selecting the internal codes independently of the names of the external options. Any given option could, in principle, be renamed without requiring changes outside of the option keyword table itself. In particular, the keywords could all be translated to a language other than English. Character sets names are an exception, and accented letters should be avoided unless the upcasing and downcasing tables are extended appropriately (see SC91316 above). The fix: SC91320. ---------------- 91/11/21 ---------------------------------------------- Kermit-370 now supports file transfers using Japanese Kanji with translation between IBM, Hitachi, or Fujitsu codes and the newly added transfer character set JAPAN-EUC. Since the new translations require large tables, they have been isolated in a new section of the source code IK0KAN.ASM, which can be omitted. The fix: SC91325. Kanji text differs from other kinds of text files in that it has *two* different character sets associated with it, a single-byte character set (SBCS) and a double-byte character set (DBCS). Thus, it may be necessary to specify the subcommand SET FILE CHARACTER-SET twice: first, for the SBCS and, second, for the DBCS. For example, SET FIL CH CP290 and SET FIL CH FUJ would select one possible SBCS (CP290) along with the Fujitsu double-byte set. Other possible SBCS's are CP281, CP500, and H-EBCDIK-DASH. Plain "EBCDIC" is not currently allowed in combination with Kanji. It is important to specify the single-byte character set first. Note: the chosen SBCS may result in EBCDIC/ASCII translations that differ from those performed by the communications front (for non-transparent modes) -- in that case, it is necessary to SET TTABLE ON in order to transfer files. ---------------- 91/12/18 ---------------------------------------------- Kermit-370 has supported file transfer through the IBM 3174 AEA since release 4.2.1, but some conditions could hang a session after finishing a download. The fix: SC91352. ---------------- 92/1/16 ----------------------------------------------- Kermit-CICS did not drive the 3174 AEA properly in transparent mode through VTAM. The fix: SC92016. ---------------- 92/1/24 ----------------------------------------------- Kermit-CICS has a bug that could produce unpredictable results when copying to or from Kermit directory members. The fix: SC92024. ---------------- 92/1/30 ----------------------------------------------- Kermit-370 has a new FULLSCREEN controller type (the same name as a type that already existed, but served as a synonym for VTAMTTY for historical reasons). The new mode allows Kermit file transfers in a generic way on many different kinds of protocol converters, but it carries some special limitations -- packets cannot be longer than 80 bytes, and the other end must be MS-Kermit 3.12 or higher or possibly C-Kermit 5A.179 or higher. See IK0423.HLP for details on the new mode. The fix: SC92030. ---------------- 92/1/31 ----------------------------------------------- Kermit-370 is now careful to say "unknown" as the reason for cancelling a transfer halted by typing STOP. The fix: SC92031. ---------------- 92/2/21 ----------------------------------------------- The minimum size of strings to be subjected to run-length encoding has been made into a parameter in the Definitions section. The default setting, as before, is 3. Changing it to 2 may be needed to make the new FULLSCREEN mode work on certain protocol converters, such as the MICOM 7400, which convert three successive blanks into cursor motion commands (or even two!). See part C above for such an update. The fix: SC92052. ---------------- 92/3/4 ------------------------------------------------ Getting out of server mode by entering STOP no longer requires hitting ENTER an extra time. The fix: SC92064. ---------------- 92/3/12 ----------------------------------------------- The Hydra II tends to lock up upon receiving an Erase-Write command with no data. Kermit-370 formerly used such a command to condition the screen for an XECHO or XTYPE or to start Kermit protocol mode when DELAY was set to 0. The problem is now avoided by including a single blank in such cases. The fix: SC92072. ---------------- 92/3/25 ----------------------------------------------- Kermit protocol now includes a special checksum type called BLANK-FREE-2 intended to avoid the possibility of multiple blanks in Kermit packets. This can be necessary in FULLSCREEN mode for certain types of protocol converter, such as the MICOM 7400. The fix: SC92085. ---------------- 92/4/22 ----------------------------------------------- Kermit-370 now supports synonym CP1047 for the default file character set EBCDIC, following IBM recognition of the de facto standard and the registration of that character set. The fix: SC92113. ---------------- 92/4/23 ----------------------------------------------- Kermit-CICS now decides correctly whether even-numbered years are leap years (it had a logical test backwards, so that directory member dates recorded beginning 1992 Feb 29 were one day late). The fix: SC92114. ---------------- 92/4/29 ----------------------------------------------- Kermit-370 has changed the calling sequence of the KERMAIL, KERMPRT, and KERMSUB commands that it invokes in support of local mail, print, and job submission. At the first invocation (for verifying that the desired operation is feasible), Kermit passes a dummy filespec consisting of the single character "." instead of passing none at all. The fix: SC92120. Implementers take note! ---------------- 92/5/5 ------------------------------------------------ Kermit-CICS now attempts to prevent clashes in accessing TDQs by using the CICS ENQ/DEQ facility. If a TDQ is "busy", Kermit will wait up to three seconds before deciding that the file is unavailable. The fix: SC92126. ---------------- 92/5/13 ----------------------------------------------- Kermit-CICS is now at level 4.2.3. The fix: SC92134. Also, IKXTRN has been updated to avoid the harmless, but upsetting, error messages about extraneous blank lines inserted by LIBR in the update stream. ---------------- 92/5/27 ----------------------------------------------- Kermit-CICS now correctly detects an end-of-file signal from a PGM file. The fix: SR92148. This update is included in 4.2.3. ---------------- 92/5/29 ----------------------------------------------- Kermit-CICS is now at level 4.2.4. The fix: SC92150. The only changes from 4.2.3 are an expansion of the Kermit userid field from four bytes to eight and the resulting change in the key size of the KSDS used for Kermit Help and TAKE files. See IKXKER.INS for migration info. ---------------- 92/6/10 ----------------------------------------------- Kermit-370 now appends an extra message to the normal protocol-mode greetings, provided DELAY is at least 2. The extra message is of the form "KERMIT READY TO SEND..." (or RECEIVE or SERVE). The fix: SC92161. ---------------- 92/6/17 ----------------------------------------------- Kermit-370 has a new TDUMP option available when the assembly-time TRACE option is enabled. Specifying TDUMP TRACE prints a dump of the trace table. Note that the new option is permitted only if TRACE is enabled. The fix: SC92169. ---------------- 92/6/26 ----------------------------------------------- In order to satisfy the restrictions of the F assembler (still used at many sites running CICS under VSE), the TITLE and PRINT ops at the start of open code have been moved after the definitions of global variable symbols. The fix: SC92178. ---------------- 92/8/20 ----------------------------------------------- Kermit-370 now supports the Thai character set. The fix: SC92233. ---------------- 92/12/17 ---------------------------------------------- Kermit-370 now uses TTABLE logic for both the DEBUG and SIM subcommands. The fix: SC92352. ---------------- 93/1/6 ------------------------------------------------ Kermit-CICS can be run under CICS 3.1 (and presumably 3.2). In addition to setting the release number appropriately, the following update: ./ * SC93006 - Compatibility with CICS 3 ./ I 01248000 $ 1248200 200 01/06/93 17:10:50 AIF ('&SYSPARM' LT '3.1').CICS3 @SC93006 TDDCTSDS EQU TDEXASDS Ptr to SDSCI in CICS 3 @SC93006 DCTSDSTF EQU DCTSDTF TYPEFILE status @SC93006 .CICS3 ANOP @SC93006 ---------------- 93/1/14 ----------------------------------------------- Kermit-370 now prints a nominal efficiency rating in the STATUS report if SPEED is defined. The fix: SC93014. ------------------------------------------------------------------------